home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / FILER / DICOTTERY.SPK / !Dicottery / !Help next >
Text File  |  1996-07-14  |  8KB  |  189 lines
  1. !Help for Dicottery v0.01 (Sun 14th July 1996)
  2.  
  3.  
  4. You may have noticed I've rewound the version number right back to 0.01.
  5. This is for two reasons...
  6.  
  7. 1:    This is a completely rewritten version of Dicottery, in C.
  8. 2:    Version 3.09 was getting a bit ridiculous ;-)
  9.  
  10.  
  11.  
  12. WHAT IS DICOTTERY?
  13. ~~~~~~~~~~~~~~~~~~
  14. There are a lot of compression programs around.  Unfortunately, most of them
  15. suffer from one major problem.  This problem is that to decompress what
  16. you've compressed (and get your original data back), you need a program
  17. (or decompressor) to do this.  This poses an enormous problem if you've
  18. just (to save space on your disc) compressed your decompressor.  Yes, I've
  19. done this before, and I had to go over to a friends' to get another copy of
  20. the decompressor :-).
  21.  
  22. Dicottery, however, overcomes this problem in one simple step.  What it does
  23. is to produce archives which decompress themselves.  These are known as
  24. Self-Extracting Archives (SEAs) (and from now on, I'll refer to the archives
  25. Dicottery produces as DSEAs).
  26.  
  27.  
  28.  
  29. WHAT ARE THE BENEFITS OF DICOTTERY?
  30. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  31. There is the obvious benefit, of course, that you don't need a decompressor.
  32. All archives produced by Dicottery are Absolute files (&FF8) and will
  33. decompress themselves via a save box if you double-click on them.
  34.  
  35. Dicottery is also FreeWare.  You don't have to pay a penny to use Dicottery!
  36.  
  37. Another main benefit is that it's fast.  When compressing, it blisters along
  38. at about 5 times the speed of SparkFS.
  39.  
  40. Here's a table of times taken with Dicottery, SparkFS and ArcFS compression.
  41. The times were taken compressing !Zap (original 1601899 bytes, or 2083K
  42. counting the space taken by directories) from RAM disc to RAM disc (to
  43. eliminate speed of hard disc).  All tests were carried out on the same
  44. RiscPC600, and were timed with my wrist watch.  The 'faster' option was
  45. used in each case.
  46.  
  47.         |  Dicottery         |  ArcFS          |  SparkFS
  48. ----------------+--------------------+--------------------+---------------
  49. Time taken    |  37s             |  46s          |  127s
  50. ----------------+--------------------+--------------------+---------------
  51. Archive size    |  878248 bytes         |  908945 bytes      |  703538 bytes
  52. ----------------+--------------------+--------------------+---------------
  53. Size reduction    |  19.1 K/s         |  14.7 K/s      |  6.9 K/s
  54. per second    |             |              |
  55.  
  56. So it seems Dicottery is the most efficient of the three :-).
  57.  
  58.  
  59.  
  60. SO WHAT'S THE BAD NEWS?
  61. ~~~~~~~~~~~~~~~~~~~~~~~
  62. Well, the worst part about Dicottery is that its archives, though they will
  63. decompress on other Acorn machines (anything with Risc-OS in fact), won't
  64. decompress on anything else.  SparkFS, however, can produce Zip files, which
  65. are compatible with anything.  However, if you're producing software, for
  66. example, for Acorn machines (like I am), you only need things to decompress
  67. on Acorns anyway.
  68.  
  69. The other main problem is to do with the size of the archive.  SparkFS and
  70. ArcFS can handle any size of archive, but DSEAs, due to their self-extracting
  71. nature, have to be completely loaded into memory before they are even run,
  72. and so you can't decompress any DSEA that's larger than your available
  73. memory.  This, however, will be solved in the future with a read-only
  74. filing system.  I've been contemplating writing one for some time, and I
  75. just have to give it a go :-).
  76.  
  77.  
  78.  
  79. HOW DO I USE DICOTTERY?
  80. ~~~~~~~~~~~~~~~~~~~~~~~
  81. It's quite simple, and there's plenty of interactive !Help support.  All
  82. you do is drag an application or directory onto the Dicottery icon (on
  83. the icon bar), and a save box will open.  Drag the icon off there, and
  84. Dicottery will start producing a self-extracting archive there.  Dicottery
  85. can handle as many compression jobs at once as can fit into memory.
  86.  
  87.  
  88.  
  89. ARE YOU GOING TO WRITE THE BORING BIT?
  90. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  91. Yes, I'm afraid I am.  Here goes...
  92. Dicottery (this term includes the program, and all associated files included
  93. in the original release of version 0.01 of Dicottery) is copyright Phil
  94. Norman Sun 14th July 1996.  It is freeware, which means you can copy and
  95. distribute Dicottery as much as you wish, as long as no charge is made
  96. (with the exception of a small charge made by PD libraries for time and
  97. materials) and all files are included unaltered.
  98. If you want to include Dicottery as part of a commercial package, or want
  99. to publish it as part of a magazine package, you must contact me first.  It
  100. is illegal to distribute Dicottery in such a way without my express written
  101. permission.
  102. I accept no responsibility for ANYTHING that may EVER happen to you, your
  103. family, anyone you will ever meet, or indeed any item of animate or inanimate
  104. materials that you may ever own, see, or know of.  This software is provided
  105. as-is, and I can accept no responsibility for it not working, crashing your
  106. filer, or for the screenshots being from a version you don't have.
  107. I accept no responsibility for any damage or loss of anything caused by
  108. this program or any other, even if I've been advised of the possibiliy of
  109. such a loss (now where did I get that one from? ;-).
  110. I reserve the right to change the conditions and licence of Dicottery at
  111. any time, to change the code and specifications of the program at any time,
  112. or to put deliberate bugs in the program to check that you're awake.
  113.  
  114.  
  115.  
  116. WHAT'S NEW IN DICOTTERY?
  117. ~~~~~~~~~~~~~~~~~~~~~~~~
  118. If you've used Dicottery before, you may want to know if I've fixed all
  119. those hideous bugs you keep telling me about ;-).  Well, one of the most
  120. hideous and nasty bugs is sorted!  That was the one that would cause the
  121. DSEA to die screaming with the error message 'Unrecognised string'.  I know
  122. what it was now - when I was storing/compressing the files, I was checking
  123. for file types (that's as in R0 on exit from OS_File,5) of 1.  As a result,
  124. files of type 3 (image filing systems, eg ArcFS archives, StrongHelp
  125. manuals) were not being stored at all when the relevant filing system was
  126. loaded.  This is now fixed - if Dicottery finds a file of type 3, it'll
  127. treat it just like a file of type 1.
  128. Also, a new thing.  Alex Howarth was complaining about incomplete archives.
  129. Basically, if a Dicottery archive is incomplete, it usually crashes the
  130. computer.  This was especially a problem for Alex, running the OuijaBoard
  131. BBS on his computer and all (OuijaBoard, BTW, is certainly the best BBS
  132. about).  Now, DSEAs will, on loading, check that a 'special word' (yeah,
  133. one of those) exists at a certain position in memory (just after the end
  134. of compressed data).  This special word is "Phil" (guess why ;-)  and if
  135. it isn't there, it usually means that the end of the file hasn't loaded
  136. in, and therefore the file wasn't complete.  In such a situation, the DSEA
  137. will exit considerately with the concise, but descriptive error message
  138. 'Archive incomplete'.
  139.  
  140.  
  141.  
  142. HOW DO I CONTACT YOU?
  143. ~~~~~~~~~~~~~~~~~~~~~
  144. Me?  You want to contact ME?  I'm flattered!  No - it's probably a bug.
  145. *grin*
  146. OK - you can reach me at...
  147.  
  148. email:    P.C.F.Norman@ex.ac.uk    (or py95pcfn@ex.ac.uk)
  149.  
  150. British Mail:    Phil Norman,
  151.         21 Priory Road,
  152.         Exeter,
  153.         Devon,
  154.         England.
  155.         EX4 7AW
  156.  
  157. (or during holidays)...
  158.         Phil Norman,
  159.         1 Claredale Road,
  160.         Exmouth,
  161.         Devon,
  162.         England.
  163.         EX8 2EE
  164.  
  165. URL:    http://newton.ex.ac.uk/general/ug/norman
  166.  
  167.  
  168.  
  169.  
  170. ANYTHING MORE TO SAY?
  171. ~~~~~~~~~~~~~~~~~~~~~
  172. Just a big THANKYOU! to all those who have helped make Dicottery what it is
  173. today.  Special thanks go to the following...
  174.  
  175. Matthew Godbolt        (Exeter uni)
  176. Tim Wiser        (IRC #acorn)
  177. indy911            (IRC #acorn)
  178. Eli-Jean Leyssens    (IRC #acorn)
  179. Justin Fletcher        (IRC #acorn)
  180. Carol Carpenter        (IRC #acorn)
  181. Andy Page        (Exeter uni)
  182. Jonix            (IRC #acorn)
  183. All those on IRC #acorn not already mentioned.
  184. All those on the OakTree talker.
  185. All those on Egham Hills 90210.
  186. John Kortink        (Wrote the LZW module)
  187. Inventor of coffee
  188. Acorn            (computers)
  189.